Overview | Package | Class | Use | Tree | Deprecated | Index | Help
| JavaTM 2 Platform Std. Ed. v1.4.0
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## javax.swing.plaf.basic
Class BasicProgressBarUI

    java.lang.Object
      |
      +--javax.swing.plaf.ComponentUI
            |
            +--javax.swing.plaf.ProgressBarUI
                  |
                  +--javax.swing.plaf.basic.BasicProgressBarUI

Direct Known Subclasses:
  MetalProgressBarUI

public class BasicProgressBarUI
extends ProgressBarUI

A Basic L&F implementation of ProgressBarUI.

Nested Class Summary
`class` | `BasicProgressBarUI.ChangeHandler` This inner class is marked "public" due to a compiler bug.

Field Summary
`protected ChangeListener` | `changeListener`
`protected JProgressBar` | `progressBar`

Constructor Summary
`BasicProgressBarUI()`

Method Summary
`static ComponentUI` | `createUI(JComponent x)` Returns an instance of the UI delegate for the specified component.
`protected int` | `getAmountFull(Insets b, int width, int height)` This determines the amount of the progress bar that should be filled based on the percent done gathered from the model.
`protected int` | `getAnimationIndex()` Gets the index of the current animation frame.
`protected Rectangle` | `getBox(Rectangle r)` Stores the position and size of the bouncing box that would be painted for the current animation index in `r` and returns `r`.
`protected int` | `getCellLength()` Returns the width (if HORIZONTAL) or height (if VERTICAL) of each of the indivdual cells/units to be rendered in the progress bar.
`protected int` | `getCellSpacing()` Returns the spacing between each of the cells/units in the progress bar.
`Dimension` | `getMaximumSize(JComponent c)` Returns the specified component's maximum size appropriate for the look and feel.
`Dimension` | `getMinimumSize(JComponent c)` The Minimum size for this component is 10.
`protected Dimension` | `getPreferredInnerHorizontal()`
`protected Dimension` | `getPreferredInnerVertical()`
`Dimension` | `getPreferredSize(JComponent c)` Returns the specified component's preferred size appropriate for the look and feel.
`protected Color` | `getSelectionBackground()` The "selectionBackground" is the color of the text when it is painted over an unfilled area of the progress bar.
`protected Color` | `getSelectionForeground()` The "selectionForeground" is the color of the text when it is painted over a filled area of the progress bar.
`protected Point` | `getStringPlacement(Graphics g, String progressString, int x, int y, int width, int height)` Designate the place where the progress string will be painted.
`protected void` | `incrementAnimationIndex()` Sets the index of the current animation frame, to the next valid value, which results in the progress bar being repainted.
`protected void` | `installDefaults()`
`protected void` | `installListeners()`
`void` | `installUI(JComponent c)` Configures the specified component appropriate for the look and feel.
`void` | `paint(Graphics g, JComponent c)` Delegates painting to one of two methods: paintDeterminate or paintIndeterminate.
`protected void` | `paintDeterminate(Graphics g, JComponent c)` All purpose paint method that should do the right thing for almost all linear, determinate progress bars.
`protected void` | `paintIndeterminate(Graphics g, JComponent c)` All purpose paint method that should do the right thing for all linear bouncing-box progress bars.
`protected void` | `paintString(Graphics g, int x, int y, int width, int height, int amountFull, Insets b)`
`protected void` | `setAnimationIndex(int newValue)` Sets the index of the current animation frame to the specified value and requests that the progress bar be repainted.
`protected void` | `setCellLength(int cellLen)`
`protected void` | `setCellSpacing(int cellSpace)`
`protected void` | `startAnimationTimer()` Starts the animation thread, creating and initializing it if necessary.
`protected void` | `stopAnimationTimer()` Stops the animation thread.
`protected void` | `uninstallDefaults()`
`protected void` | `uninstallListeners()` Removes all listeners installed by this object.
`void` | `uninstallUI(JComponent c)` Reverses configuration which was done on the specified component during `installUI`.

Methods inherited from class javax.swing.plaf.ComponentUI
`contains, getAccessibleChild, getAccessibleChildrenCount, update`

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

Field Detail

### progressBar

    protected JProgressBar progressBar

### changeListener

    protected ChangeListener changeListener

Constructor Detail

### BasicProgressBarUI

    public BasicProgressBarUI()

Method Detail

### createUI

    public static ComponentUI createUI(JComponent x)

  Description copied from class: `ComponentUI`
  Returns an instance of the UI delegate for the specified component. Each subclass must provide its own static `createUI` method that returns an instance of that UI delegate subclass. If the UI delegate subclass is stateless, it may return an instance that is shared by multiple components. If the UI delegate is stateful, then it should return a new instance per component. The default implementation of this method throws an error, as it should never be invoked.

### installUI

    public void installUI(JComponent c)

  Description copied from class: `ComponentUI`
  Configures the specified component appropriate for the look and feel. This method is invoked when the `ComponentUI` instance is being installed as the UI delegate on the specified component. This method should completely configure the component for the look and feel, including the following:
  1. Install any default property values for color, fonts, borders, icons, opacity, etc. on the component. Whenever possible, property values initialized by the client program should not be overridden.
  2. Install a `LayoutManager` on the component if necessary.
  3. Create/add any required sub-components to the component.
  4. Create/install event listeners on the component.
  5. Create/install a `PropertyChangeListener` on the component in order to detect and respond to component property changes appropriately.
  6. Install keyboard UI (mnemonics, traversal, etc.) on the component.
  7. Initialize any appropriate instance data.

  Overrides:
    `installUI` in class `ComponentUI`
  Parameters:
    `c` - the component where this UI delegate is being installed
  See Also:
    `ComponentUI.uninstallUI(javax.swing.JComponent)`, `JComponent.setUI(javax.swing.plaf.ComponentUI)`, `JComponent.updateUI()`

### uninstallUI

    public void uninstallUI(JComponent c)

  Description copied from class: `ComponentUI`
  Reverses configuration which was done on the specified component during `installUI`. This method is invoked when this `UIComponent` instance is being removed as the UI delegate for the specified component. This method should undo the configuration performed in `installUI`, being careful to leave the `JComponent` instance in a clean state (no extraneous listeners, look-and-feel-specific property objects, etc.). This should include the following:
  1. Remove any UI-set borders from the component.
  2. Remove any UI-set layout managers on the component.
  3. Remove any UI-added sub-components from the component.
  4. Remove any UI-added event/property listeners from the component.
  5. Remove any UI-installed keyboard UI from the component.
  6. Nullify any allocated instance data objects to allow for GC.

  Overrides:
    `uninstallUI` in class `ComponentUI`
  Parameters:
    `c` - the component from which this UI delegate is being removed; this argument is often ignored, but might be used if the UI object is stateless and shared by multiple components
  See Also:
    `ComponentUI.installUI(javax.swing.JComponent)`, `JComponent.updateUI()`

### installDefaults

    protected void installDefaults()

### uninstallDefaults

    protected void uninstallDefaults()

### installListeners

    protected void installListeners()

### startAnimationTimer

    protected void startAnimationTimer()

  Starts the animation thread, creating and initializing it if necessary. This method is invoked when the progress bar changes to indeterminate mode. If you implement your own animation thread, you must override this method.

  Since:
    1.4

### stopAnimationTimer

    protected void stopAnimationTimer()

  Stops the animation thread. This method is invoked when the progress bar changes from indeterminate to determinate mode and when this UI is uninstalled. If you implement your own animation thread, you must override this method.

  Since:
    1.4

### uninstallListeners

    protected void uninstallListeners()

  Removes all listeners installed by this object.

### getPreferredInnerHorizontal

    protected Dimension getPreferredInnerHorizontal()

### getPreferredInnerVertical

    protected Dimension getPreferredInnerVertical()

### getSelectionForeground

    protected Color getSelectionForeground()

  The "selectionForeground" is the color of the text when it is painted over a filled area of the progress bar.

### getSelectionBackground

    protected Color getSelectionBackground()

  The "selectionBackground" is the color of the text when it is painted over an unfilled area of the progress bar.

### getCellLength

    protected int getCellLength()

  Returns the width (if HORIZONTAL) or height (if VERTICAL) of each of the indivdual cells/units to be rendered in the progress bar. However, for text rendering simplification and aesthetic considerations, this function will return 1 when the progress string is being rendered.

  Returns:
    the value representing the spacing between cells
  See Also:
    `setCellLength(int)`, `JProgressBar.isStringPainted()`

### setCellLength

    protected void setCellLength(int cellLen)

### getCellSpacing

    protected int getCellSpacing()

  Returns the spacing between each of the cells/units in the progress bar. However, for text rendering simplification and aesthetic considerations, this function will return 0 when the progress string is being rendered.

  Returns:
    the value representing the spacing between cells
  See Also:
    `setCellSpacing(int)`, `JProgressBar.isStringPainted()`

### setCellSpacing

    protected void setCellSpacing(int cellSpace)

### getAmountFull

    protected int getAmountFull(Insets b,
                                int width,
                                int height)

  This determines the amount of the progress bar that should be filled based on the percent done gathered from the model. This is a common operation so it was abstracted out. It assumes that your progress bar is linear. That is, if you are making a circular progress indicator, you will want to override this method.

### paint

    public void paint(Graphics g,
                      JComponent c)

  Delegates painting to one of two methods: paintDeterminate or paintIndeterminate.

  Overrides:
    `paint` in class `ComponentUI`
  Parameters:
    `g` - the `Graphics` context in which to paint
    `c` - the component being painted; this argument is often ignored, but might be used if the UI object is stateless and shared by multiple components
  See Also:
    `ComponentUI.update(java.awt.Graphics, javax.swing.JComponent)`

### getBox

    protected Rectangle getBox(Rectangle r)

  Stores the position and size of the bouncing box that would be painted for the current animation index in `r` and returns `r`. Subclasses that add to the painting performed in this class's implementation of `paintIndeterminate` -- to draw an outline around the bouncing box, for example -- can use this method to get the location of the bouncing box that was just painted. By overriding this method, you have complete control over the size and position of the bouncing box, without having to reimplement `paintIndeterminate`.

  Parameters:
    `r` - the Rectangle instance to be modified; may be `null`
  Returns:
    `null` if no box should be drawn; otherwise, returns the passed-in rectangle (if non-null) or a new rectangle
  Since:
    1.4
See Also:
  `setAnimationIndex(int)`

### paintIndeterminate

    protected void paintIndeterminate(Graphics g,
                                      JComponent c)

  All purpose paint method that should do the right thing for all linear bouncing-box progress bars. Override this if you are making another kind of progress bar.

  Since:
    1.4
See Also:
  `paintDeterminate(java.awt.Graphics, javax.swing.JComponent)`

### paintDeterminate

    protected void paintDeterminate(Graphics g,
                                    JComponent c)

  All purpose paint method that should do the right thing for almost all linear, determinate progress bars. By setting a few values in the defaults table, things should work just fine to paint your progress bar. Naturally, override this if you are making a circular or semi-circular progress bar.

  Since:
    1.4
See Also:
  `paintIndeterminate(java.awt.Graphics, javax.swing.JComponent)`

### paintString

    protected void paintString(Graphics g,
                               int x,
                               int y,
                               int width,
                               int height,
                               int amountFull,
                               Insets b)

### getStringPlacement

    protected Point getStringPlacement(Graphics g,
                                       String progressString,
                                       int x,
                                       int y,
                                       int width,
                                       int height)

  Designate the place where the progress string will be painted. This implementation places it at the center of the progress bar (in both x and y). Override this if you want to right, left, top, or bottom align the progress string or if you need to nudge it around for any reason.

### getPreferredSize

    public Dimension getPreferredSize(JComponent c)

  Description copied from class: `ComponentUI`
  Returns the specified component's preferred size appropriate for the look and feel. If `null` is returned, the preferred size will be calculated by the component's layout manager instead (this is the preferred approach for any component with a specific layout manager installed). The default implementation of this method returns `null`.

  Overrides:
    `getPreferredSize` in class `ComponentUI`
  Parameters:
    `c` - the component whose preferred size is being queried; this argument is often ignored, but might be used if the UI object is stateless and shared by multiple components
  See Also:
    `JComponent.getPreferredSize()`, `LayoutManager.preferredLayoutSize(java.awt.Container)`

### getMinimumSize

    public Dimension getMinimumSize(JComponent c)

  The Minimum size for this component is 10. The rationale here is that there should be at least one pixel per 10 percent.

  Overrides:
    `getMinimumSize` in class `ComponentUI`
  Parameters:
    `c` - the component whose minimum size is being queried; this argument is often ignored, but might be used if the UI object is stateless and shared by multiple components
  Returns:
    a `Dimension` object or `null`
  See Also:
    `JComponent.getMinimumSize()`, `LayoutManager.minimumLayoutSize(java.awt.Container)`, `ComponentUI.getPreferredSize(javax.swing.JComponent)`

### getMaximumSize

    public Dimension getMaximumSize(JComponent c)

  Description copied from class: `ComponentUI`
  Returns the specified component's maximum size appropriate for the look and feel. If `null` is returned, the maximum size will be calculated by the component's layout manager instead (this is the preferred approach for any component with a specific layout manager installed). The default implementation of this method invokes `getPreferredSize` and returns that value.

  Overrides:
    `getMaximumSize` in class `ComponentUI`
  Parameters:
    `c` - the component whose maximum size is being queried; this argument is often ignored, but might be used if the UI object is stateless and shared by multiple components
  Returns:
    a `Dimension` object or `null`
  See Also:
    `JComponent.getMaximumSize()`, `LayoutManager2.maximumLayoutSize(java.awt.Container)`

### getAnimationIndex

    protected int getAnimationIndex()

  Gets the index of the current animation frame.

  Since:
    1.4

### setAnimationIndex

    protected void setAnimationIndex(int newValue)

  Sets the index of the current animation frame to the specified value and requests that the progress bar be repainted. Subclasses that don't use the default painting code might need to override this method to change the way that the `repaint` method is invoked.

  Parameters:
    `newValue` - the new animation index; no checking is performed on its value
  Since:
    1.4
See Also:
  `incrementAnimationIndex`

### incrementAnimationIndex

    protected void incrementAnimationIndex()

  Sets the index of the current animation frame, to the next valid value, which results in the progress bar being repainted. The next valid value is, by default, the current animation index plus one. If the new value would be too large, this method sets the index to 0. Subclasses might need to override this method to ensure that the index does not go over the number of frames needed for the particular progress bar instance. This method is invoked by the default animation thread every X milliseconds, where X is specified by the "ProgressBar.repaintInterval" UI default.

  Since:
    1.4
See Also:
  `setAnimationIndex`

Overview | Package | Class | Use | Tree | Deprecated | Index | Help
| JavaTM 2 Platform Std. Ed. v1.4.0
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

Submit a bug or feature
For further API reference and developer documentation, see Java 2 SDK SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Java, Java 2D, and JDBC are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries.
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.